home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / bg.z / bg
Text File  |  1998-10-30  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. bbbbgggg((((1111))))                                                                    bbbbgggg((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      bbbbgggg - run jobs in the background
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      bbbbgggg [jjjjoooobbbb____iiiidddd ...]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      If job control is enabled (see the description of sssseeeetttt ----mmmm in the sssshhhh((((1111))))
  16.      manpage), the bbbbgggg utility resumes suspended jobs from the current
  17.      environment by running them as background jobs. If the job specified by
  18.      jjjjoooobbbb____iiiidddd is already a running background job, the bbbbgggg utility has no effect
  19.      and will exit successfully.
  20.  
  21.      Using bbbbgggg to place a job into the background causes its process ID to
  22.      become "known in the current shell execution environment", as if it had
  23.      been started as an asynchronous list.
  24.  
  25. OOOOPPPPEEEERRRRAAAANNNNDDDDSSSS
  26.      The following operand is supported:
  27.  
  28.      jjjjoooobbbb____iiiidddd    Specify the job to be resumed as a background job. If no jjjjoooobbbb____iiiidddd
  29.                operand is given, the most recently suspended job is used. The
  30.                format of jjjjoooobbbb____iiiidddd is described in the entry for job control job
  31.                ID in the ((((sssshhhh)))) manpage.
  32.  
  33. SSSSTTTTDDDDOOOOUUUUTTTT
  34.      The output of bbbbgggg consists of a line in the format:
  35.  
  36.           "[%d] %s\n", <job-number>, <command>
  37.  
  38.      where the fields are as follows:
  39.  
  40.      <job-number>      A number that can be used to identify the job to the
  41.                        wwwwaaaaiiiitttt, ffffgggg and kkkkiiiillllllll utilities. Using these utilities, the
  42.                        job can be identified by prefixing the job number with
  43.                        "%".
  44.  
  45.      <command>         The associated command that was given to the shell.
  46.  
  47. EEEEXXXXIIIITTTT SSSSTTTTAAAATTTTUUUUSSSS
  48.      The following exit values are returned:
  49.  
  50.      0   Successful completion.
  51.  
  52.      >0  An error occurred.
  53.  
  54. CCCCOOOONNNNSSSSEEEEQQQQUUUUEEEENNNNCCCCEEEESSSS OOOOFFFF EEEERRRRRRRROOOORRRRSSSS
  55.      If job control is disabled, the bbbbgggg utility will exit with an error and no
  56.      job will be placed in the background.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. bbbbgggg((((1111))))                                                                    bbbbgggg((((1111))))
  71.  
  72.  
  73.  
  74. AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN UUUUSSSSAAAAGGGGEEEE
  75.      A job is generally suspended by typing the SUSP character (<control>Z).
  76.      At that point, bbbbgggg can put the job into the background. This is most
  77.      effective when the job is expecting no terminal input and its output has
  78.      been redirected to non-terminal files. A background job can be forced to
  79.      stop when it has terminal output by issuing the command:
  80.  
  81.           stty tostop
  82.  
  83.      A background job can be stopped with the command:
  84.  
  85.           kill -s stop job ID
  86.  
  87.      The bbbbgggg utility will not work as expected when it is operating in its own
  88.      utility execution environment because that environment will have no
  89.      suspended jobs. In the following examples:
  90.  
  91.            ... | xargs bg
  92.  
  93.           (bg)
  94.  
  95.      each bbbbgggg operates in a different environment and will not share its parent
  96.      shell's understanding of jobs. For this reason, bbbbgggg is generally
  97.      implemented as a shell regular built-in.
  98.  
  99. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  100.      ffffgggg((((1111)))),,,, kkkkiiiillllllll((((1111)))),,,, jjjjoooobbbbssss((((1111)))),,,, sssshhhh((((1111)))),,,, wwwwaaaaiiiitttt((((1111))))....
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.